Hypertext features

LATEX is inherently suitable for specifying hypertext documents since it encourages description of the logical structure of a document using section commands. Therefore, a LATEX document is automatically a hypertext document, without any further editing.

For Windows Help, a single RTF is generated with topics corresponding to sections. A top level contents page shows each chapter or top-level section, and each chapter or section ends with a list of further sections or subsections. Similarly, a single wxHelp XLP file may be generated.

For HTML, a different file is generated for each section, since the XMOSAIC browser works best with a large number of small files. The files are named automatically based on the name of the output file, with the contents page filename being formed from the output filename with _contents appended to the name. This may result in the generation of several hundred files for a large LATEX input file.

To specify explicit jumps around a hypertext file, the helprefhelpref macro is used. The first argument is the text to be displayed at the point of reference, which will be highlighted in a hypertext file to allow jumping to a reference. The second argument is the reference label (there should be a corresponding labellabel command in the file, following a section or figure).

A first optional argument (written in square brackets) specifies a filename which contains the given reference. (Not yet implemented.)

To use extra features such as helpref and the C++ and CLIPS class reference documentation features, include the style file texhelp.sty.